---
title: "dub.workspaces.list"
sidebarTitle: "List"
"og:title": "dub.workspaces.list - Retrieve a list of workspaces - TypeScript SDK"
description: "Retrieve a list of workspaces for the authenticated user."
---

import WorkspaceResponse from "/snippets/workspace-response.mdx";

## Response

<WorkspaceResponse />

<RequestExample>

```ts
await dub.workspaces.list({});
```

</RequestExample>

<ResponseExample>

```ts
[
  {
    id: "clv3mw4qb00008tvuw86c53db",
    name: "Acme",
    slug: "acme",
    logo: null,
    usage: 0,
    usageLimit: 1000,
    linksUsage: 0,
    linksLimit: 25,
    domainsLimit: 3,
    tagsLimit: 5,
    usersLimit: 1,
    plan: "free",
    stripeId: null,
    billingCycleStart: 17,
    createdAt: "2024-04-17T09:52:27.635Z",
    users: [{ role: "owner" }],
    domains: [],
  },
];
```

</ResponseExample>
